The User Presence Controller (attached to Gameboard) exposes all the presence features as well as keep an internal collection of the active users on the board.

Video Walkthrough:

The Gameboard prefab is always available in your game as long as the SDK has been integrated. In order to access it from our custom Mono Behavior we just need to find it by its tag.

    GameObject gameboardObject = GameObject.FindWithTag("Gameboard");

With access to our Gameboard object we can then move on to obtain a reference to the UserPresence controller. This is the controller that handles all the functions related to User Presence.

We will first need to define a reference to the controller to make it available throughout our script:

    UserPresenceController userPresenceController;

With our listener defined, we can now proceed to listen for user presence event. In our case we'll have a function called OnUserPresence handle this events.

We also want to make sure to initialize any users that were connected to the gameboard before the game started up, we can do this by checking if the userPresenceController is initialized. If it is initialized we will call OnUserPresenceControllerInitialized right away, and if it isn't we want to subscribe to the UserPresenceControllerInitialized event to fire off the OnUserPresenceControllerInitialized method whenever the userPresenceController is ready.

    userPresenceController = gameboardObject.GetComponent<UserPresenceController>();

    userPresenceController.OnUserPresence += OnUserPresence;

    if (userPresenceController.IsInitialized)
    {
        OnUserPresenceControllerInitialized();
    }
    else
    {
        userPresenceController.UserPresenceControllerInitialized += OnUserPresenceControllerInitialized;
    }

Now that we are able to receive the user presence events all that remains is to handle them in the game.

Here we process any user presence updates in OnUserPresences, where any users that were around on initialization will be handled in OnUserPresenceControllerInitialized.

    void OnUserPresence(GameboardUserPresenceEventArgs userPresence)
    {
        // Handle changes in User Presence here.
    }

    void OnUserPresenceControllerInitialized()
    {
        foreach (var user in userPresenceController.Users.Values)
        {
            // Initialize existing users here
        }
    }

GameboardUserPresenceEventArgs useful properties

• userId: Player's id
• display: Username of this player
• unityColor: The user's token color converted to a Color object
• boardUserPosition: A BoardUserPosition object with information about this players location on the board
• status: An enum indicating companion device connection
  • NULL: No connection
  • ACTIVE: Device is actively connected.
  • IDLE: Connection has been lost but the user device did not leave the board.
• changePrevious: The event arguments of the previous change
• changeValue: Enum indicating what type of userPresence change has occurred
  • UNKNOWN
  • ADD
  • REMOVE
  • CHANGE
  • CHANGE_POSITION
• presenceTypeValue: Type of presence this user is as an enum
  • DRAWER: connected only through the drawer on gameboard
  • COMPANION: connected with a mobile device
  • NONE
• userTypeValue: Type of user as an enum - NONE - USER: Logged in with a permanent UserID. - GUEST: Guest user with a generated userID not associated with a Gameboard account. - OPEN: Open seat with no user. - HOST: User logged into the host drawer.

Although we are working in a managed environment it is always a good idea to clean the listeners when no longer needed.

    void OnDestroy()
    {
        userPresenceController.OnUserPresence -= OnUserPresence;
        userPresenceController.UserPresenceControllerInitialized -= OnUserPresenceControllerInitialized;
    }

This section include the entire code in one single, easy to copy section.

    UserPresenceController userPresenceController;

    void Start()
    {
        GameObject gameboardObject = GameObject.FindWithTag("Gameboard");
        userPresenceController = gameboardObject.GetComponent<UserPresenceController>();

        userPresenceController.OnUserPresence += OnUserPresence;

        if (userPresenceController.IsInitialized)
        {
            OnUserPresenceControllerInitialized();
        }
        else
        {
            userPresenceController.UserPresenceControllerInitialized += OnUserPresenceControllerInitialized;
        }
    }

    void OnUserPresence(GameboardUserPresenceEventArgs userPresence)
    {
        // Handle User Presence here.
    }

    void OnUserPresenceControllerInitialized()
    {
        foreach (var user in userPresenceController.Users.Values)
        {
            // Initialize existing users here
        }
    }

    void OnDestroy()
    {
        userPresenceController.OnUserPresence -= OnUserPresence;
        userPresenceController.UserPresenceControllerInitialized -= OnUserPresenceControllerInitialized;
    }